<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8"/>
    <title>gmfs 文件服务器 api</title>
</head>
<body>
<div style="margin-top:80px;">
----------------------------------------------<br/>
<strong style="font-size:30px"># api 说明</strong><br/>
----------------------------------------------<br/>
code 		响应编码<br/>
----------------------------------------------<br/>
1000		正常消息<br/>
1001		异常消息<br/>
1002		保存失败<br/>
1003		读取失败<br/>
1004		超过限制大小，默认小于80M<br/>
1005		图片涉黄<br/>
1006		不支持文件<br/>
----------------------------------------------<br/>
message 	响应内容<br/>
----------------------------------------------<br/>
1、code 为 1000 正常消息，时 message 为响应结果<br/>
2、其他情况为错误描述<br/>
----------------------------------------------<br/>
rdm 		随机数（重置图片使用）<br/>
----------------------------------------------<br/>
mime		文件展类型，例如 "image/jpeg" , "application/pdf" 等<br/>
----------------------------------------------<br/>
suffix 		上传文件后缀<br/>
----------------------------------------------<br/>
<br/>
<br/>
演示 demo 地址：http://localhost:1323/demo.html<br/>
----------------------------------------------<br/>
<strong style="font-size:30px">（1）、POST 上传</strong><br/>
----------------------------------------------<br/>
地址：/upload.html<br/>
参数：file		文件属性名<br/>
参数：nude		可选（检查是否涉黄 true 是， false 否）<br/>
参数：online		可选（全局允许上线 online 为 false 不允许上线才生效，true 是， false 否）<br/>
参数：resetId 	可选（resetId 与 resetRdm 同时存在,替换指定图片）<br/>
参数：resetRdm 	可选（resetId 与 resetRdm 同时存在,替换指定图片）<br/>
演示地址：http://localhost:1323/upload.html<br/>
返回 JSON 例如：<br/>
{<br/>
    "code": "1000",<br/>
    "message": "55c83f2a07986a0838000003",<br/>
    "mime": "image/jpeg",<br/>
    "rdm": "L5Ap4",<br/>
    "suffix": ".jpg"<br/>
}<br/>
<br/>
----------------------------------------------<br/>
<strong style="font-size:30px">（2）、GET 上传</strong><br/>
----------------------------------------------<br/>
地址：/proxy.html<br/>
参数：uri		文件地址<br/>
参数：nude		可选（检查是否涉黄 true 是， false 否）<br/>
参数：online		可选（全局允许上线 online 为 false 不允许上线才生效，true 是， false 否）<br/>
参数：resetId 	可选（resetId 与 resetRdm 同时存在,替换指定图片）<br/>
参数：resetRdm 	可选（resetId 与 resetRdm 同时存在,替换指定图片）<br/>
演示地址：http://localhost:1323/proxy.html?uri=http://p5.qhimg.com/dmt/490_350_/t01d49b7191cbc97c11.jpg<br/>
返回 JSON 例如：<br/>
{<br/>
    "code": "1000",<br/>
    "message": "55c83f2a07986a0838000003",<br/>
    "mime": "image/jpeg",<br/>
    "rdm": "L5Ap4",<br/>
    "suffix": ".jpg"<br/>
}<br/>
<br/>
----------------------------------------------<br/>
<strong style="font-size:30px">（3）、显示（原样输出 byte 流）</strong><br/>
----------------------------------------------<br/>
地址：/dispaly/:id.html?watermark=true<br/>
参数：id			唯一ID（上传成功 message 返回的字符串）<br/>
参数：watermark	可选（只对图片有效，全局设置不开启水印，请求可通过该参数打开水印 true 是， false 否）<br/>
演示地址：http://localhost:1323/dispaly/55c83f2a07986a0838000003.html<br/>
<br/>
# 图片缩放处理 #<br/>
1、等比缩放 100 像素<br/>
http://localhost:1323/dispaly/55c83f2a07986a0838000003_100.html<br/>
<br/>
2、缩放为 100x100 像素<br/>
http://localhost:1323/dispaly/55c83f2a07986a0838000003_100x100.html<br/>
<br/>
注意！限制宽高大于 50 像素, 宽高小于2倍的实际像素。<br/>
<br/>
----------------------------------------------<br/>
<strong style="font-size:30px">（4）、文件下载</strong><br/>
----------------------------------------------<br/>
地址：/download/:id.html?name=xx<br/>
参数：id			唯一ID（上传成功 message 返回的字符串）<br/>
参数：name		可选（文件名称，默认使用 id 命名）<br/>
演示地址：http://localhost:1323/download/55c83f2a07986a0838000003.html<br/>
		http://localhost:1323/download/55c83f2a07986a0838000003.html?name=20150806<br/>
<br/>
----------------------------------------------<br/>
<strong style="font-size:30px">（5）、秒传（查询是否存在）</strong><br/>
----------------------------------------------<br/>
地址：/search/:md5/:size.html<br/>
参数：md5	文件 md5 值<br/>
参数：size	文件大小（单位 B 字节）<br/>
演示地址：http://localhost:1323/search/3fbef3c587cf53c88b282b614cad105f/34562.html<br/>
{<br/>
    "code": "1000",<br/>
    "message": "55c83f2a07986a0838000003",<br/>
    "mime": "image/jpeg",<br/>
    "rdm": "L5Ap4",<br/>
    "suffix": ".jpg"<br/>
}<br/>
<br/>
----------------------------------------------<br/>
<strong style="font-size:30px">（6）、文件转正（开启文件失效功能，才需要转正）</strong><br/>
----------------------------------------------<br/>
地址：/online/:id/:rdm.html<br/>
参数：id		唯一ID<br/>
参数：rdm	随机数<br/>
演示地址：http://localhost:1323/online/55c83f2a07986a0838000003/L5Ap4.html<br/>
{<br/>
    "code": "1001",<br/>
    "message": true<br/>
}<br/>
<br/><br/><br/><br/>
</div>
</body>
</html>